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Kernel-Mode Driver Architecture: Windows DDK 

Splitting Transfer Requests js 

Any driver might need to split up a transfer request and carry out more than one DMA transfer 

operation to satisfy a given IRP, depending on the following: >» 

• The number of map registers retumed by loGetDmaAdapter — 

• The bytes of data to be transferred, contained in the Length member of the driver's I/O stack 3> 
location for the IRP ^ 

• The number of page boundaries, in system physical memory, for the buffer into which or from jt| 
which the driver is to transfer data ^ 

• Device-specific constraints on the driver's DMA operations. For example, the system "AT" disk Q 
driver must split up transfer requests for more than 256 sectors due to the disk controller's "O 
limitations. 



A driver can determine the number of map registers needed to transfer all the data specified by an IRP 
as follows: 



1 . Call MitiGetMdlVirtualAddress . passing a pointer to the MDL at Irp->MdL4ddress, to get the 

starting virtual address for the buffer. Note that a driver must not attempt to access memory using 
this virtual address. The value retumed by MmGetMdlVirtuaL4ddress is an index into the MDL, 
not necessarily a valid address. 

2. Pass the retumed index and the value of Length in the driver's I/O stack location of the IRP to the 
ADDRESS AND SIZE TO SPAN PAGES macro. 



If the value retumed by ADDRESS_AND_SIZE_TO_SPAN_PAGES is greater than the 
NumberOJMapRegisters value retumed by loGetDmaAdapter, the driver cannot transfer all requested 
data for this IRP in a single DMA operation. Instead, it must do the following: 

1 . Split the buffer into pieces that are sized to suit the number of available map registers (and any 
device- specific DMA constraints). 

2. Carry out as many DMA operations as it takes to satisfy the transfer request. 

For example, suppose ADDRESS_AND_SIZE_TO_SPAN_PAGES indicates that twelve map registers 
are needed to satisfy a transfer request, but the NumberOfMapRegisters value retumed by 
loGetDmaAdapter is only five. (Assume no device-specific DMA constraints.) In this case, the driver 
must carry out three DMA transfer operations, calling MapTransfer three times to transfer all the data 
requested by the IRP. 

The system's DMA device drivers use various techniques to split up a DMA transfer when there are not 
enough map registers to satisfy an IRP with a single I/O operation. One technique to use is the 
following: 

1 . Call loAUocateMdl to allocate an MDL describing a portion of the user buffer. 
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2. Call MmProbeAndLockPages to lock down that portion of the user buffer. 

3. Transfer the data for that portion of the buffer. 

4. Call MmUnlockPages and do either of the following: 
o If the MDL that the driver allocated in Step 1 is large enough for the next piece of the 

transfer, call MmPrepareMdlForReuse and repeat Steps 2 through 4. 
o Otherwise, call loFreeMdl and repeat Steps 1 through 4. 

5. Call MmUnlockPages and loFreeMdl when all the data has been transferred. 

If a highest-level driver cannot lock down the entire user buffer with MmProbeAndLockPages ma ^ 
machine with limited memory, it can do the following: 0) 

1 . Call loBuildSvnchronousFsdRequest to allocate a partial-transfer IRP and lock down a portion ^ 
of the user buffer. The locked-down area is usually either a multiple of PAGE_SIZE or is sized to ^ 
suit the underlying device's transfer capacity. 

2. Call loCallD river for the partial-transfer IRP, and call KeWaitForSin gleOb i ect to wait on an 
event object that the driver set up to be associated with its partial-transfer IRP, if lower drivers 
return STATUS_PENDING. m 

3. When it regains control, repeat Steps 1 and 2 until all the data has been transferred, and, then, ^ 
complete the original IRP. O 

When a storage class driver splits up large transfer requests for underlying SCSI port/miniport drivers, 
it allocates an additional IRP for each piece of the transfer request. It registers an loCompletion routine 
for each driver-allocated IRP, to track the status of the full transfer request and to free the 
driver-allocated IRPs. Then it sends these IRPs on to the port driver using loCallDriver . 

Other class/port drivers can use this technique only if the class driver can determine how many map 
registers are available to the port driver. The port driver must store this configuration information in the 
registry for the paired class driver, or the paired drivers must define a private interface, using internal 
device I/O control requests, to pass configuration information about the number of available map 
registers from the port driver to the class driver. 

A monolithic driver (that is, a driver not part of a class/port pair) for a DMA device must split up large 
transfer requests for itself Such drivers usually split a large request into pieces and carry out a sequence 
of DMA operations in order to satisfy the IRP. 

If a transfer request is too large for the underlying device driver to handle, a higher-level driver can call 
MmGetMdl Virtu alAddr ess and loBuildPartialMdl . then set up a sequence of partial-transfer IRPs 
for underlying device drivers. 
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